home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / rack_002.zip / RACK_002.DOC < prev   
Text File  |  1992-08-27  |  6KB  |  169 lines
  1. Remote Access Cdrom Kit, Version 0.02 Documentation
  2. Like all lazy programmers, I get tired of redundant entries someone else
  3. has made.  The programs inside this file handle 2 major problems that are
  4. now history.
  5.  
  6. 1> True CD-ROM support.  ImpArea will import a files.ra file, and optionally
  7.    remap the drive letters so you don't have to go through and clean up.
  8.    It also allows you to setup securities and other options for imported areas.
  9.  
  10.    This assumes that there is a Files.RA on the CD to play with, and
  11.    files.### as well. After importing the areas into your system's
  12.    Files.ra, simply copy the files.### into your CDRom files.bbs
  13.    directory, and you're done.
  14.  
  15. 2> MoveArea.  Does just that.  Type either program name for help.
  16.    Movearea was originally released about 6 months ago into the sds, and now
  17.    added is CDRom support smarter moving and non-violent access of files.
  18.    Refer to movearea.ctl for configuration.
  19.  
  20. The following is the example IMPSDN.BAT file that comes with this release:
  21.  
  22.  
  23. @Echo off
  24. REM Example batch file for importing of the files in the SDNPlus CDRom
  25. REM into your current existing Remote Access Files.RA
  26. REM don't forget to copy your original Files.RA to some other name.
  27. If Not Exist d:\RA\MyFiles.RA Goto Oops
  28.  
  29. :Note1
  30. d:
  31. cd d:\ra\cdrom
  32. del Files.*
  33. Xcopy j:\00index\Files.*
  34. Attrib -r *.*
  35. Del Files.79
  36. cd..
  37. :Note2
  38. ImpArea d:\ra\cdrom\files.ra 1 78 J /UL65535 /DL100 /LS10 /N- /L- /D+
  39. MoveArea 1 78 73
  40. ImpArea d:\ra\MyFiles.RA 1 71
  41. ImpArea d:\ra\MyFiles.RA 190 10
  42.  
  43. Goto End
  44. :Oops
  45. Echo Please Read the batch file before blindly running it!
  46. Echo Aborting...
  47. :End
  48.  
  49. Explaination of batch file:
  50.  
  51. Note1:  All of the files.### and Files.RA files are copied into a
  52. directory where your files.### files are stored.  In my case, this path
  53. is d:\ra\cdrom
  54.  
  55. Note2:  ImpArea imports the files.RA areas 1 thru 79 (78 areas
  56.         starting with file area 1, and Replaces the first letter of the
  57.         filepath designator with J.  Also, Upload Security is set to 65535,
  58.         Download to 100, and list to 10, new file search is disabled, Long
  59.         discriptions are disabled, and Dupe checking enabled.
  60.  
  61.  
  62. Note3:  MoveArea moves file areas 1-78 to 73-150, and renames the
  63.         files.### accordingly. (Make sure to edit MoveArea.CTL so that it
  64.         knows where your CDRom Files.### files are.)
  65.  
  66. Note4:  ImpArea imports the first 71 areas of your previously setup
  67.         files.RA file, which has hopefully been renamed to MyFiles.RA
  68.  
  69. For this to work properly, there must be a files.RA file on the CDRom
  70. or in the path defined, And files.### files as well, or copies from a
  71. friend in some directory.
  72.  
  73. ImpArea.EXE
  74. ImpArea Command line parameters:
  75.         ImpArea File1 Start Count CDRom_Letter /Flags
  76.  
  77.         File1 is the fully qualified path to the CD or other files.ra file.
  78.  
  79.         Start is the starting file area you would like to import from
  80.         this file.
  81.  
  82.         Count is the number of file areas to import.
  83.  
  84.         CDRom_Letter is optional, but if used, remaps all imported areas
  85.         to the letter specified.  In the example batch file, All areas
  86.         imported will be remapped to drive J
  87.  
  88.  
  89.         Flags are defined as follows and are entirely optional:
  90.  
  91.         /D[+/-] Turns dupe checking on or off accordingly for new areas
  92.                 imported.
  93.  
  94.         /N[+/-] Turns New Files on or off accordingly for new areas
  95.                 imported.
  96.         /L[+/-] Turns Long discriptions on or off accordingly for new areas
  97.                 imported.
  98.  
  99.  
  100.         /UL#####
  101.         /LS#####
  102.         /DL#####
  103.  
  104.         Set Upload, List and Download security levels for all areas imported.
  105.  
  106.         The lack of presence of any flags will import areas as they were set
  107.         in the files.RA to be imported.
  108.  
  109.  
  110. MoveArea.EXE
  111. Original code by Bo Bendtsen 2:231/111@Fidonet
  112. New Features by Joe Jared 1:125/1212@Fidonet
  113. MoveArea command line parameters:
  114.         MoveArea Start End To
  115.  
  116.         Start is the starting area number you want to move.
  117.         End   is the last area you want to move.
  118.         To    is the destination of these areas.
  119.  
  120.         Areas can be moved even if they overlap, as it will either
  121.         move areas in reverse or forward order as needed.
  122.  
  123.         CDRom Support:  When CDRom is defined in MoveArea.CTL, the
  124.         files.### in this path are renamed accordingly as the areas are
  125.         moved.
  126.  
  127.  
  128. -- New since 0.01
  129.  
  130. ImpArea.EXE
  131.  
  132. Added Import Securities and options for Upload/Download/list security,
  133. Newfiles,Long Discription, and Dupes option.
  134.  
  135. ImpArea now updates the files.RA in the current directory if it exists, or
  136. the one in the system directory if it doesn't.
  137.  
  138. Note:  For those of you with an interest in more than 200 file areas,
  139. this program could very well suit your needs until Remote Access is
  140. updated to handle them. Drives.MNU shows one example of how considerably
  141. more than 200 file areas could be made available for your callers, by
  142. allowing them to select file areas more to their liking. In the example
  143. menu, 4 such groups are setup, each given the name specified in the menu
  144. option, and upon return from the door call, these new file areas would
  145. become active.  Multinode users would be totally unaffected by these
  146. changes, simply because there would be a unique files.ra for each node.
  147. With even further creativity, multiple CD rom drives could be included
  148. as well.
  149.  
  150. Example:
  151. Environment variables used:
  152. TCNode = do determine which node is changing areas
  153. Menu Type 7
  154. Menu Data
  155. *C /C IMP Group1 J:\00index
  156.  
  157. IMPareas.BAT
  158. del d:\ra\CDROM%TCNODE%\Files.*
  159. If Not '%2' == '' Xcopy %\Files.* D:\RA\CDROM%TCNODE%
  160. Attrib -r *.*
  161. ImpArea d:\ra\%1.ra 1 199
  162.  
  163. In this example, each node has it's own set of CDRom files.### files,
  164. and after importing areas a second parameter is checked for.  If this
  165. second parameter is nul, no files are copied, but if not, the new
  166. files.### files are copied over, and the user now has access to other
  167. file areas.
  168.  
  169.